home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_4 / kbfilgen.lha / KBGFILEG.DOC < prev   
Text File  |  1994-09-05  |  7KB  |  237 lines
  1.                           KBGfileGenerator v1.0
  2.                          ~~~~~~~~~~~~~~~~~~~~~~~
  3.                                    by
  4.  
  5.                            Kasper B. Graversen
  6.                           ~~~~~~~~~~~~~~~~~~~~~
  7.  
  8.  
  9.  
  10.  
  11.     NOTE NOTE NOTE   NOTE NOTE NOTE   NOTE NOTE NOTE   NOTE NOTE NOTE
  12.  
  13.  
  14.     The author cannot be held liable for the suitability or accuracy
  15.     of this manual and/or the program it describes. Any damage
  16.     directly or indirectly caused by the use or misuse of this manual
  17.     and/or the program(s) it describes is the sole responsibility of
  18.     the user her/him self.
  19.  
  20.     KBGfileGenerator, (c) Copyright 1994,
  21.     Kasper B. Graversen. All rights reserved. This program is
  22.     ShareWare, so donations ARE required. You may use this program for
  23.     14 days after that you MUST either pay the registration fee or
  24.     delete the program again!
  25.  
  26.     This program may be freely distributed, as long as all
  27.     documentation and executable remain unchanged, and are included
  28.     with the distribution. Also no profit is to be made by selling
  29.     this program (except a small copy fee of max. $2)
  30.  
  31.  
  32.  
  33.    YAWN - Yet another doc-file.. hmm I'mm make it short this time! .-)
  34.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.  
  36.  
  37.     INTRODUCTION.
  38.     ~~~~~~~~~~~~~
  39.     This is a filelist generator for the MAXs BBs system. It has been
  40.     tested on v1.52 and v1.54 and should work older versions also. When
  41.     registered it is (what I believe) the best filelist generator for
  42.     the MAXs BBs system!
  43.  
  44.  
  45.     USAGE.
  46.     ~~~~~~
  47.     At first KBGfileGenerator may seem a bit heavy to work with because
  48.     of all the parameters, But it was designed to be activated from a
  49.     script so it really isn't that bad.. :)
  50.  
  51.     The template is as follows:
  52.  
  53.     KBGfileGenerator ALL [file.data-file] [area-file] [output-file]
  54.  
  55.  
  56.  
  57.  
  58.     ALL            - Is a flag to be set so KBGfileGenerator know what type
  59.                      of filelist to generate. In the unregistered version
  60.                      you can only generate one type of filelist though.
  61.  
  62.  
  63.     file.date-file - This is the filename of the file "file.data" MAXs'
  64.                      is creating. But you should not only write the name,
  65.                      but the whole path. In my case it's
  66.                      "bbs:files/file.data"
  67.  
  68.     area-file      - KBGfileGenerator needs an area file telling it the
  69.                      names of the different file areas.
  70.  
  71.  
  72.     output-file    - Here you specify the outputfile + path. Eg.
  73.                      "T:filelist.txt".
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.     The Area file.
  83.     ~~~~~~~~~~~~~~
  84.     The Areafile is a simple ASCII file. It contains the names of the
  85.     different areas on your BBs. Each line contains the name of the
  86.     equivalent file area (section). In other words - If you write "free
  87.     files" on line 1 and you generate a filelist, and have some files in
  88.     section one, the file area will be named Free files in your file list.
  89.     To edit the area file you can use an ordinary fileeditor, but remember
  90.     that the areafile must contain 99 lines, if you start deleting "empty
  91.     area numbers" the file area names in the file list will screew up!
  92.     So if you haven't got any files in section 10 and 11 but in 9 and 12,
  93.     just let the numbers "10" and "11" be where they are.
  94.     You can make some nice filelists by adding some ansi in the area names
  95.     - try it!  Eg. you can make the areanames in one colour and the filenames
  96.     in another by writing: (ansi code col2) free files (ansi code col3)
  97.  
  98.     By doing so the area names will be colour 2, while the filenames will
  99.     be colour 3. You could specify different ansi colour codes after
  100.     the area name so your filelist could contain all the colours of the
  101.     rainbow :-)
  102.  
  103.  
  104.  
  105.  
  106.  
  107.     SCRIPT.
  108.     ~~~~~~~
  109.     Here is the script I execute every time I'm updating my filelist.
  110.  
  111.  
  112.     bbs:kbgfilegenerator ALL bbs:files/file.data bbs:kbgfilegenerator.areas t:filelist.txt
  113.  
  114.     delete bbs:files/freefiles/filelist.txt
  115.     copy t:filelist.txt bbs:files/freefiles/filelist.txt
  116.     delete bbs:files/freefiles/filelist.lha
  117.     lha a bbs:files/freefiles/filelist.lha t:filelist.txt
  118.     delete t:filelist.txt
  119.  
  120.  
  121.     Simple, eh? :-)
  122.  
  123.  
  124.  
  125.  
  126.  
  127.     GOODIES.
  128.     ~~~~~~~~
  129.     I've kept some goodies for the registered users:
  130.  
  131.   + You can specify which file areas that should not be in the filelist
  132.     (eg. SYSOP FILES, MEMBERS ONLY etc. etc.)
  133.  
  134.   + You can make a filelist containing files that are up to n days old.
  135.     n is a number you specify when you run KBGfileGenerator - Now it's
  136.     no problem making filelist covering the last 7 days files.
  137.  
  138.   + You can make a list of files that are not yet published. This was
  139.     Rene Jensen's idea, thanx.. it's really useful!
  140.  
  141.   + KBGfileGenerator will put a * after all files that are less than 30
  142.     days old. This will make the output like this:
  143.  
  144.     PT315.lha               96989 * [00] 01-09-94 ProTracker v3.15 aga
  145.  
  146.     instead of:
  147.     PT315.lha               96989   [00] 01-09-94 ProTracker v3.15 aga
  148.  
  149.  
  150.  
  151.  
  152.  
  153.     REGISTERING.
  154.     ~~~~~~~~~~~~
  155.     The prices.
  156.  
  157.     40 Dkr (KBGfileGenerator) (40 Dkr = 10 DM)
  158.      5 Dkr (for a brand new 3.5" floppy disc)
  159.      6 Dkr (postage for people living in Scandinavia)
  160.     10 Dkr (postage for people living in Europe)
  161.     12 Dkr (postage for people living outside Europe)
  162.  
  163.  
  164.     I prefer danish money, but accept foreign currencies aswell. If
  165.     you pay with a foreign currency please add a some extra cash to
  166.     cover some of the exchange fees I have to pay in the bank.
  167.  
  168.     You can send your money to me by mail at this address, but REMEMBER
  169.     it is on your OWN risk. I can not in any way be responsible for
  170.     lost letters!
  171.  
  172.         Kasper B. Graversen
  173.         Sandhoej 9
  174.         5700 Svendborg
  175.         Denmark
  176.  
  177.         E-mail:
  178.         2:237/15.48   (FidoNet)
  179.         39:141/105.60 (AmigaNet)
  180.  
  181.         You can also reach me on my hotline phone: (+45) 62 21 64 74
  182.  
  183.  
  184.  
  185.     You can also send the money in a more secure way.. through your bank.
  186.  
  187.     Transfer your money to:
  188.         Svendborg Sparekasse
  189.         Centrumpladsen 19
  190.         5700 Svendborg
  191.         Denmark
  192.  
  193.         Name: Kasper B. Graversen.
  194.  
  195.         reg. nr:    0844
  196.         account nr: 815-57-28982
  197.  
  198.  
  199.  
  200.         If you live in Denmark or you got a free phone you can save some
  201.         money by collecting the registered version of KBGfileGenerator at
  202.         my BBs!
  203.  
  204.  
  205.  
  206.  
  207.     TO DO.
  208.     ~~~~~~
  209.     I've got some few things in my TODO list.
  210.     + You can add an ASCII file automatically in the filelist, with eg. a
  211.       message telling that the filelist is is the filelist for YOUR BBs.
  212.  
  213.     + Add some more statistics.
  214.     
  215.     + YOUR ideas...
  216.  
  217.  
  218.     These things will NOT be implemented in KBGfileGenerator unless I see
  219.     some response from users. So please support me! I've also done some
  220.     postcardware programs, so it's not profit all of it! I've spent HOURS
  221.     doing this one and some of the code has been used in some other MAX
  222.     utils I'm working on now...
  223.  
  224.  
  225.  
  226.     ps:
  227.     ~~~
  228.     I myself got an A1200, but even though I've got a 020 in my machine
  229.     I've only put a 000 version in this archive because there really
  230.     weren't much difference in speed - so why double the size of the
  231.     archive when it really doesn't matter?
  232.  
  233.  
  234.     C ya m8 - Kasqer..
  235.  
  236.  
  237.